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1 INTRODUCTION 

1.1 SCOPE 

1.1.1 Identification 

Computer Software Configuration Item (CSCT): Naval Interactive Data Analysis System - 
Climatology (NIDAS-C) 

Version; 2.0 

Release Data: To be determined at a later date 

Contract No: NRL N000 1 4-92-C-6032 Mod P00009 

NASA NAS 13-564 D.O. 82 

Contractor: Mississippi State University 

Center for Air Sea Technology 
J.H. Corbin, Director 
Building 1103, Room 233 
Stennis Space Center, MS 39529-6000 
Telephone: (601) 688-2561 
Facsimile: (601)688-7100 

Principal Investigator: Mr. Clifton Abbott 

Mississippi State University 
Center for Air Sea Technology 
Building 1 103, Room 233 
Stennis Space Center, MS 39529-6000 
Telephone: (601) 688-3085 
Facsimile: (601)688-7100 

1.1.2 System Overview 

The objective of the NIDAS project is to provide NAVOCEANO with an interactive overlay ca- 
pability for several types of oceanographic, meteorological, and satellite derived data, and create 
3-D gridded fields of temperature and salinity profiles constructed from a combination of "prov* 
inced” data (user derived) and gridded data. NIDaS-C provides interactive blending and overlay- 
ing capabilities for a broad range of climatology data. 
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1.1.3 Data Overview 

NIDAS-C operates using numerous oceanographic data categories stored in an installed version 
of the Naval Environmental Operational Nowcast System (NEONS), a relational database manage- 
ment system (rdbms) which employs the ORACLE proprietary rdbms engine. Data management, 
configuration, and control functions for the supporting rdbms are performed externally. NIDAS-C 
stores and retrieves data to/ffom the rdbms but exercises no direct internal control over the rdbms 
or its configuration. Data is also ingested into the rdbms, for use by NIDAS-C, by ex’emal data ac- 
quisition processes. The data categories employed by NTDAS-C are as follows; 

• Bathymetry - ocean depth at V minute resolution 

• Coastline - vector coordinates of the shoreline at several different resolu- 
tions from the World Vector Shoreline (WVS) datasets 

• GDEM, GRID1, GRID2 - gridded fields of temperature, salinity, and 
sound speed provided by NAVOCEANO 

• MOODS, AUX1, A1JX2 - oceanographic profiles of temperature, salinity, 
and sound speed versus depth stored in the formats prescribed by the Mas- 
ter Oceanographic Observation Data Set (MOODS) 

1.1.4 Functionality Overview 

In the MIL-STD 2167a terminology, NIDAS-C is a Computer Software Configuration Item 
(CSCI). It is composed of four Computer Software Components (CSC), through which the function- 
ality of NIDAS-C is achieved. The CSC’s are as follows: 

• Graphical User Interface 1 (GUI 1) - incorporates window manage- 
ment, user interface and display functionality; 

« Graphical User Interface 2 (GUI 2) - incorporates window manage- 
ment, user interface and display functionality; 

• Data Retrieval Module (DRM) - provides functional data management 
using relational RDBMS technology; and 

<■ Da " interactive Module (DIM) - incorporates data processing, applica- 
tion of intet active methods and algorithms to the data, and graphical (visu- 
alization) processing of the data. 

NIDAS-C has one external interface; the User-GUl interface which includes two graphical user 
interfaces. The User-GT.JI interface supports 1 ) user control of NIDAS-C using interactive tech- 
niques and 2) response^ edback to the user in the form of data display (graphical or numerical) and 
status indicators. 

Figure 1 illustrates the NIDAS-C Top Level module and external interface architecture. NI- 
DAS-C is the Computer Software Configuration Item (CSCI). There arc four Computer Software 
Components (CSC). 
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('SCI: NIDAS-C 


r 



Figure 1. Top-Level modular structure of the Naval Interactive Data Analysis System - Cli- 
matology (NIDAS-C). 


1.1.5 Support Overview 

This manual is the main document for NIDAS-C user support. System specifications are de- 
scribed in the NTDAS-C design document. Other additional support is contained in documentation 
for integrated proprietary (commercial) software, such as Oracle, and non-developed (government 
provided) software, such as the Naval Environmental Operational Nowcast System (NEONS). 

1.1.6 Document Overview 

The purpose of this document is to describe the functionality o' NIDAS-C and the techniques' 
procedures that users may employ in producing a useful oceanographic product using NIDAS-C. 
Appendix A contains a list of definitions used in this document. Appendix B contains a list acro- 
nyms. Appendix C contains a set of instructions on how to install NIDAS-C. 

1.2 Conventions 

To simplify and standardize the communication of procedural details to the user, this manual 
adopts the following conventions: 

• Mouse Button Convention: Most “click" or "select" operations with the 
mouse use the left button. Unless otherwise specified, instructions to 
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•’click” or "select” refer to the left mouse button. When a "click” or "se- 
lect" using the middle or right mouse button is required, the specific 
mouse button will be indicated in the text; otherwise the left mouse button 
should be assumed. 

• Dragging the Mouse: Dragging the mouse refers to clicking the left 
mouse button, moving the mouse across the screen, and then releasing the 
mouse button. 

• Non-interactlve Textboxes: Textboxes with a buff-colored background 
are non— interactive. They provide information only and cannot be modi- 
fied by the user. 


1.3 Referenced Documents 

This user’s manual either contains references to the following documents, or summarizes in- 
formation contained in them appropriate for further reading. 

1.3. 1 DOD-STD 2167 A "Defense- System Software Development”, AMSC No. N4327, 29 Feb 
1988. 

1 .3.2 Mississippi State University proposal number 94-3-537 (Option F to the Tactical Oceano- 
graphic Wide Area Network Support Contract N00014— 92 — C— 6032) dated 17 January 1994. 

1 .3.3 Naval Research Laboratory Modification P00009 to Contract N0001 4-92--C-6032 dated 
16 August: 1994. 

1.3.4 NASA NAS 13-564 Delivery Order 82 dated 23 May 1996. 

1.3.5 “Design Document and Database Specifications for the Naval Interactive Data Analysis 
System— Climatologic.i (NIDAS-C), V' .'sion 2.0", Technical Note 02-96, Mississippi State Univer- 
sity, Center for Air Se hnology, 30, September 1 996. 

1.2.6 Young, Douglas A., “The X Windows System Programming and Applications with Xt, 
OSF/Motif Edition", Prentice Hall, Englewood Cliffs, NJ, 1990. 

1 .3.7 Jurkevics, Andrew, "Database Design Document for the Naval Environmental Operation- 
al Nowcast System, Version 3.5”, Naval Oceanographic and Atmospheric Research Laboratory, 
Monterey, CA, 1 June 1992. 

1.3.8 “Database Design Document for NEONS Volume tric Data", Ensemble Systems Corpora- 
tion, Hartford, CT, 1 March 1993. 

1.3.9 Users Manual and References Guides for UNIRAS ag/X Toolmaster Graphics Extensions 
Library, Version 6v4a, UNIRAS, Incorporated, Overland Park, KS, 1993, 

1.3.10 Coffin, Stephen, “UNIX System V Release 4: the Complete Refetence", Osborne 
McGraw-Hill, New York, NY, 1990. 
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2 EXECUTION PROCEDURES 

2.1 Initialization (Launching the Application) 

NIDAS observes the standard procedure for executing an application in the UNIX/X- Windows 
environment. At the UNIX command line prompt, enter nidas-c. When X-Windows initialization 
procedures are complete the NIDAS-C GUI 1 or “Top-Level Window” display will appear. If using 
“Toms Window Manager"- “twm-c”, a window skeleton appears on screen which must toe maneu- 
vered to the desired position on the monitor screen with the mouse. If using “motif window' manag- 
er”— “mwmrc", the position of the main display is predefined and appears without any further action 
after entering nidas-c from the keyboard. Other window managers may involve different user action 
before the ‘Top-Level Window” display appears. 

2.2 Description of Display Windows 

The screen displays of NIDAS-C are X-Windows client window objects. Window control ad- 
heres to X-Windows procedures. As illustrated in Figure 2, die Top Level Window consists of 1) 
Globe ...up, 2) Latitude / Longitude , .pacification, 3) Menu bar, and 4) Title area. The design of 
the Main Window is subdivided into the following areas (as shown in Figure 3): 1) the title area, 2) 
the “Main Chart” which provides a geographical display, 3) the “Profile Chart" which displays the 
GDEM, GRID 1 , GRID2, MOODS, AUX 1 , and AUX2 profiles, 4) a pull-down menu bar containing 
various options for interacting widi the “Main Chart” and “Profile Chart” windows, and 5) a “Re- 
mark” area which communicates important messages to the user. Figure 9 displays the DRM "Data 
Selection” window, and the DIM “Data Retrieval” window. The “Data Selection" window consists 
of “Options”, “Data", and “Display" for each of the data types. The “Data Retrieval” window con- 
sists of the Zoom, Polygon, Polygon Options, and Grid areas. 

2.2.1 Top Level Window (NIDAS-C GUI I) 

The NIDAS-C GUI 1 (see Figure 2) manages ore of the links bet ween the user and NIDAS-C. 
Through this GUI the user can specify the region of interest by dragging the mouse across the region 
of interest in the globe map. The GUI indicates the selected region by displaying a rectangle across 
the region and also displaying the latitude / longitude coordinates of die region in the “REGION 
COORDINATES" text area. From the “File” pulldown menu, the user can perform one of three op- 
erations: 1) bring up the Main Window GUI by selecting the “Nidas” button, 2) clear any region 
specified by selecting the “Reset" button, and 3) exit from the application by selecting the "Exit" 
button. 
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Figure 2. NIDAS-C “Top Level Window" display screen. 

Any specified region can be zoomed by selecting the “ZOOM" button which produces a pop-up 
window containing the zoomed region. The user can fuither sub— select a legion from the zoomed 
region by dragging the mouse across the region of interest. The pop-up window is dosed when the 
middle mouse button is clicked while the mouse is in the pop-up window. The top level window 
GUI will be updated to reflect any region specified in the zoomed region. 

By selecting the “Nidas" option from the “File" pulldown tnenu, the user can bring up the Main 
Window GUI (GUI 2). Selecting the “Nidas” option without a region being specified would result 
in an error message. By selecting the “Reset" option from the "File" pulldown menu, the Main Win- 
dow is returned to its default state. 

2.2.2 Main Window (NIDAS-C GUI 2) 

The NIDAS-C Main Window GUI (GUI 2) manages the second link between the user and NI- 
DAS-C. Through this GUI, the user exercises all available NIDAS-C control options. NIDAS-C 
provides pop-up windows for user interaction, as well as interactive functionality within the Main 
Window" itself. Data can be displayed on the "Main Chart” (left section of the main window) ar.d/or 
“Profile Composite Chart” uight section of the main window). Figure 3 illustrates the Main Win- 
dow, which is the destination for all graphical output resulting from user interaction with the other 
NIDAS-C modules. The DRM, and the DIM perform the prepai story data selection, data proces- 
sing. and data management functions required to generate the visual displays that appear within the 
Main Window. 


6 






NTDAS-C User’s Manual 


N1DAS-CLIMA TOLJG Y 


File 

SES 


Help 



Rrrnaik 


Main Cha rt 

Display Data 
distribution points, 
contours, coastlines 
and shorelines 


Accepts MOODS, 
AUXJ , AUX2, 
GDEM.GRID1, 
and GRID2 profiles 


Figure 3. NIDAS-C “Main Window” display screen. 

2.2.2. 1 Main Chart 

Th “Main Chart” section of the Main Window, as shown in Figure 3, displays plotted data in 
a geographical coordinate (map) context using contours, points, and/or user selectable area color 
fills. The “Main Chart” retains all datasets selected from the DRM during execution unless specifi- 
cally removed by deselecting it. To remove a specific data display, deactivate the “Display” button 
for the appropriate data category within the DRM “Data Selection" window (see Figure 9). When 
deactivated, the “Display” button for that: data type will no longer be highlighted. 

2.2.2.2 Profile Composite Chart 

The “Profile Composite Ch;irt” section of the Main Window, as shown in Figure 3, is used to 
plot temperature, salinity, or ‘sound speed versus depth profiles. The profile composite chart accepts 
GDEiM, GRID1, GRID2, MOODS, AU.X.1, and AUX2 profiles. To remove a plot display from the 
“Profile Composite Chart", deactivate the “Display" button for the appropriate profile data category 
within the DRM “Data Selection” window (see Figure 9). 

2.2.2.3 Menu Bar 

The NIDAS -C “Main Window'" contains a menu bar with interactive menu headers labeled 
“File", “Tools”, and “Help". Each menu header provides access to additional NIDAS--C features. 
Figure 4 illustrates all the available menu options, which are described in detail. 
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Figure 4. NIDAS-0 "Mein Window” menu headers and pulldown menu options. 

2. 2.2.3. 1 File Pulldown Menu 

The. options available front the "File” pulldown menu are “Main Window" (Main Chart). “Pro- 
file Window’’ (Profile Chart), “Select Parameter", and “Exit”. 

• “Main Chart" - The “Main Window" menu item offers the following 
choices: 

• ” Repaint ” - Selecting the “Repaint” option removes (erases) any 
polygons of locations that have been created or overbid within the 
“Main Chart". If there are no polygons or overlaid locations, no 
changes will be made to the "Main Chart’. 

• ‘ Default Region" - Selecting the “Default Region" option returns 
the “Main Chart" to its default scale or resolution subsequent to 
scaling (zoom) procedures thai nave enlarged the original resolu- 
tion of the "Main Chart" display. 

• “Axis Options " - Selecting "Axis Options" produces a pop-up 
window that allows the user to change the latitude and longitude 
interval markings (tick marks) on the “Mai i Chart” (see Figure 
5a). The axis interval values are modified by entering new values 
within the textboxes in degrees of arc. Clicking the "Ok" button 
confirms the new values and closes the window. Clicking the 
"Exit” button closes the pop-up window, but makes no changes to 
pre-existing latitude/longitude tick marks. 
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• ‘‘Profile Chart” - The “Profile Window” menu item offers option choices 
that are similar to the “Main Chart” menu item. 

• ", Repaint " - Selecting the “Repaint” option removes (erases) any 
polygons or overlaid profiles that exist for the “Profile Chart”. If 
there are no polygons or overlaid profiles, no changes will be 
made to the “Profile Chart’. 

• "Axis Options" - Selecting the “Axis Options” brings up a pop-up 
window that allows the user to change the X Min, X Max, Y Mm, 
and Y Max range limits for the "Profile Chart” (see Figure 5b). 
Changes can be made by entering new values in the respective 
textboxes. Clicking the “Ok” button confirms the new values and 
closes the window. Clicking the “Exit” button closes the pop-up 
window, but makes no charges to pre-existing range limit values. 


Axis < )ptions 


La t'iick 
Lon Tick 


2f)0(K)04) ] 

2^000000 | 



(a) 


Axis Options 


X Min 

iio.ooooob | 

XMax 

30.000000 1 

Y Min 

[o.oooooo 

Y Max 

MOO.OOOOOO 


[oTT] [Kxjt] 

(b) 


Figure 5. (a) The NIDAS-C "Axis Options" pop-up window for the "Main Chart" . 

(b) The NIDAS-C "Axis Options" poj -up window for the “Profile Chart”. 
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• Select Parameter - The "Select Parameter” menu item allows selection 
of the parameter to be displayed on the horizontal axis of the ‘‘Profile 
Chart”. The choices available are: “Temp" (temperature), “Snd Speed” 

(sound speed) and “Salinity”. After a parameter has been selected, the 
“Profile Chart” will automatically adjust, if necessary, to accommodate 
the new parameter. If the selected parameter was previously designated to 
be the active parameter, there will be no change in the ‘ Profile Chart". 

• Exit - Upon clicking the exit button, the “Exit” pop-up dialog will be dis- 
played. This pop-up window allows confirmation of the desire to exit 
(clicking the “Ok” button) or to return to the application (clicking the 
“Cancel” button). 

2.2.23.2 The Tools Pulldown Menu 

The options available from the “tools” pulldown menu are “Status”, “Export”, and “Update 
DB”. 

• Status - The “Status” menu item provides time, date, and plotting color 
information about each data type selected from the DRM “Data Selection” 
window. The "Data Selection Status” scrollable pop-up window (see Fig- 
ure 6) appears in response to the selection of the “Status" menu item. The 
status information is displayed within the “Data Selection Status" window. 

To close the “Data Selection Status” window, click the “Exit” button on 
that window. 



Figure 6. The Tools "Data Selection Status” pop- up window. 

• Export - The Tools “Export" menu item supports the export of all the 
available data types either in binary or in ASCII format. The “Export 
Data" pop-up window (see Figure 7) appears in response to the selection 
of the "Export" menu item. It provides header entry textboxes, suggested 
(default) filename(s) and, buttons for selecting binary or ASCII output. 
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Before datasets car. be exported, at least one of the exportable data types 
must have been selected, and polygons must have been constructed. De- 
pending upon the data types displayea, the “Export” menu lists filenames 
in a textbox for eacn data type. The user may enter the required informa- 
tion in the textboxes (pressing <retum> after each completed text entry). 
The “Export Data” window also allows the user to make either of the fol- 
lowing two choices: 1) All in Last Polygon (Default), which is to export 
all the profiles in the last drawn polygon, or 2) All Previous Profile Isolate 
Selections, which is to export all the selected isolated profiles. Also the 
user can select or deselect profile flags, based on “Temperature” and “Sa- 
linity”, by c lid-in g on the particular flag buttons. Once all the required 
export data has been entered, click the “Ok" button to export the data. To 
close the “Export Data” window, click the “Exit” button. 
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Figure 7. The Tools “Export Data” pop-up window, 
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• Update DB - The Tools "Update DB" menu item supports updating the 
database of the flags of individual profiles set over a period of multiple 
profile isolations discussed in section 2.2.4A. 

2.2.23.3 The Help Pulldow Menu 

The “Help” pulldown menu offers on-line assistance to the user. Help is available on “Layout", 
“Data Selecti on”, and ‘‘Data Analysis" from the menu items that appear when the “Help" menu head- 
er is selected. Help on each subject is provided in a series of pop-up help screen windows that appear 
in response to menu item selection. To close a help screen, click the “Ok ’ button on the window. 


2.2.2.4 Remark 

The buff-colored “Remark” textbox is located in the lower left comer of the “Main Window" 
display. The “Remark" textbox provides notification of errors, event status and communicates 
instructions for follow-on interaction by the user. 


2.2.2.S Repaint 

The “Repaint” button is located in the lower right comer of the “Main Window” display. “Re- 
paint” eliminates all polygons and overlaid position plots on the "Main Chart”, and overlaid profiles 
on the “Profile Chart”. Nothing happens in response to clicking “Repaint” if there are no polygons, 
position plots or overlaid profiles. 


2.2 3 Data Retrieval Module (DRM) 

The Data Retrieval Module (DRM) controls the display and selection of data for the NIDAS-C 
CSCI. User interaction with the DRM is handled via the "Data Selection" portion shown in Figvr : 
8. There are three choices for each data type listed in the “Data Selection” window. They are “Di - 
play”, “Data”, and “Options”. The “Display” buttons select data types be viewed in the “Main 
Chart” or “Profile Composite Chart” within the NIDAS “Main Window” display. 
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Figure 8. NIDAS-C Data Retrieval Module (DRM) and the Data Interactive Module (DIM) dis- 
play window, The "Data Selection” part deals v/ith the DRM while the "Interact” and the "Grid 

parts deal with the DIM 
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The “Data” buttons produce tailored dialog pop-up windows that allow selections from avail- 
able parameters contained in the dataset. The "Options” buttons produce data dialog pop-up win- 
dows tailored to each data type, offering other user options such as color. The functionality of the 
“Display", “Data" and “Options” button? ?re described for each data type category in the following 
subsections. 

2.2.3.1 BATHY (Bathymetry) 

2.2.3. 1.1 Display 

Selecting the BATHY “Display” button produces a contour plot of the bottom depth on the 
“Main Chart.” 

2. 2. 3. 1.2 Data 

Bathymetry does not vary with time or day. It is determined by the region designated for the 
“Main Chart”. The BATHY “Data” button is a non-interactive button; that is, no user interaction 
is needed in order to read the bathymetry. As soon as the "Data” button is pressed, the bathymetry 
for that region is read. 

2.2.3. 1.3 Options 

When the BATHY “Options” button is clicked, a pop-up window is produced which allow? 
modification of the maximum and minimum data values and the interval between plotted contours 
(see Figure 9). To modify values, select the appropriate text widget, enter the desired value from the 
keyboard and press the <rctum> key. The “Ok" button accepts the changes and removes the pop-up 
window. The “Reset; button restores all values to their defaults. 


' K,ith\ niclrv Options 


Min 

Max 


-3048.0 


7086.0 


Interval 100.0 j 

Reset] 


Ok 


Figure 9. DRM “Bathymetry Options” pop window. 

2.23.2 COAST (Coastline) 

2. 2. 3. 2.1 Display 

Clicking the "Display” button associated with the COAST data type plots the coastline on the 
“Main Chart". 
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2.23.2.2 Data 

Clicking the “Data” button associated with the COAST datatype produces the “Coastline Data” 
pop-up window illustrated in Figure 10. The “Coastline Data” pop-up window allows selection of 
the coas tline resolutions ( 1 , 3, 8, or 20 kilometers) which requires the user to select a particular type 
of coastline. When the “Coastline” button is clicked , a pull-down menu lists the four coastline reso- 
lutions. The selected resolution is displayed in the textbox to the right of the pulldown menu. Click- 
ing the “Ok” button accepts any changes made to coastline re solution and closes the pop-up window. 
Clicking the “Reset” button restores the coastline resolution to its default value. 



Figure 10. DRM “Coastline Data” pop-up window for the Coastline data types. 

2.23.2.3 Options 

Selecting the “Options" button associated with the COAST data type within the DRM “Data 
Selection” window produces the “Coastline Options” pop-up window as shown in Figure 11. A 
“Colors” pulldown menu offers a choice among eight different color options in which a coastline 
may be displayed on the “Main Chart". The selected color is displayed in the textbox to the right 
of the pulldown menu. Clicking the “Ok” button accepts the indicated color and closes the "Coastline 
Options” pop-up window. Clicking the “Reset” button restores the original color, which may be 
accepted (by cb-wting “Ok”) or modified again (using the “Colors” pulldown menu). 



Figure 11. DRM “Coastline Options” pop-up window for the Coastline data type. 

22.33 MOODS 

2.23.3.1 Display 

The display button for MOODS displays the MOODS location information on the Main Chari 
and profiles of Depth vs. the current parameter on the Profile Chart for the selected data set. 
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2.2.33.2 Data 

When the MOODS data button is selected, the MOODS data selection pop-up window will ap- 
pear as shown in Figure 1 2. This Window will contain various user-selectable options. The “Read” 
button initiates the retrieval of data from the database using the parameter range values shown in 
the “selection status” of the pop-up window. The “Remark” section of the “Main Window” displays 
"Reading MOODS Data” during data retrieval and “finished reading MOODS Data” when retrieval 
is completed. The “Exit” button closes the MOODS data selection pop-up window. 

The “Selection Status” section displays the currently set minimum and maximum values for the 
various parameters. When retrieving data for the database the values last displayed in the selection 
status area will be used. At any given time either the minimum or maximum values can be changed 
by selecting the “minimum” or the “maximum” button in the selection status area and selecting the 
desired values from the ’’Data Selection” are-t. 

The “Data Selection” section of the window allows the user to set the minimum and maximum 
values of tire following parameters: class code, instrument type, source code, month, cruise ID, wa- 
ter depth, latitude, longitude, parameters and time. To set any values, either the “Minimum” or 
“Maximum” button from the “Selection Status” area must be selected. The class code, instrument 
type, source code, and month can be set from their respective scrollable lists, by selecting the desired 
value on the list. The parameters can be set by moving the ’’Number of Parameters” slider bar to 
the left or right till the desired value is shown. The parameter can have one of the following values: 

• 1 - Salinity 

• 2 - Temperature 

• 3 - Both Temperature and Salinity 

• 4 - Sound Speed 

Cruise id, water depth, latitude, and longitude can be set by typing the required values in the corre- 
sponding text, boxes and pressing the <retum> key. To select a particular version, the “Versions” 
button is selected. This results in a pop-up list window as shown in Figure 13, from where the de- 
sired vmion can be selected. Time can be set by selecting the ’Time” button (see Figure 14) and 
selecting the desired time. Once a selection is made the corresponding “Minimum” or “Maximum” 
text box of the particular parameter, in the “Selection Status” area, will reflect the change. 
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Figure 12. DRM "Data Selection” pop-up window for the MOODS data type. 



Versions 

J 

Vi-rsimi 

lUrCut \linl.;il M;i\|.:il Mini on \Li\Imi 

Si. imp 1 inu 


nldn»_c_ V Sea_J an 
nldas c YSea Feb 


6079 24.00 38.87 118.20 131.00 

10137 24.00 3935 118.75 131.00 


11/07/1996 15:34:01 
06/25/1996 14:22:34 


Figure 1 3. DRM "Version Selection” pop-up window for selecting the dataset version. 
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Figure 14. DRM ‘Time Selection" pop-up window for setting MOODS date/time criteria. 
2.23.3.3 Options 

The “MOODS Options” pop-up window illustrated in Figure 1 5 supports specification of 1 ) up 
to three date ranges centered on the listed “Center Date” (Julian); 2) colors for plotting MOODS 
profiles; 3) colors for plotting polygons; 4) colors for profile isolation; 5) “On/Off* toggle buttons 
for locations, profiles, and depths; 6) profile flag settings; 7) point size for data, polygon, and isolate; 
and 8) lilic width for data, polygon, and isolate. The Julian center date is automatically calculated 
from the dataset and listed irt the "Center Date" text box. The user can also enter a different center 
date by entering a new date from the keyboard and pressing the <retum> key in the "Center Date” 
text box. Below the “Center Date” textbox are three textboxes labeled and “+”. The value 

entered in the textbox is added and subtracted from the center date to obtain a date range. To 
further reduce the lower limit of the data range, enter a number into the ” textbox. Similarly, a 
number may be entered into the ‘V textbox to increase the upper limit of the date range. For each 
Julian range entered, the user may select a color for displaying profiles falling within that date range, 
and a color for polygoned profiles within that date range. When clicked, the “Color” button produces 
a pulldown menu offering eight color options. A color may be selected by dragging the mouse cursor 
over the desired color and releasing. The selected color will be displayed within the “Color” text- 
boxes. The color is similarly set for profile isolation. The location, profile, and depths On/Off but- 
tons are set by clicking on the respective buttons. The point sizes and line widths can be set by sliding 
the respective slide bar until the desired value is shown. The desired flagged profiles can be set by 
clicking the "Profile Flags" button which brings up pop-up window (see Figure 16) and selecting 
the desired flags. Oicking the “Reset" button returns all values to their original defaults. Clicking 
the “Ok" button closes the "MOODS Options” pop-up window, accepting the criteria established 
therein. 
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Figure 15. DRM “MOODS Options” pop-up window for the MOODS data type. 
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Figure 16. DRM "Profile Flags" pop-up window for ihe MOODS data type. 


2.2.34 AUX1/AUX2 

The AUX1 and AIJX2 data types uses the same interfaces as the MOODS data type in the data, 
display, and option* categories. Refer to section 2. 2. 3. 3. 
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2.2.3 .5 GDEM 

2.23.5.1 Display 

The display button for GDEM displays the GDEM location information on the Main Chart and 
profiles of Depth vs. the current parameter on the Profile Chart for the selected data set. 

2.23.5.2 Data 

When the GDEM data buttor is selected, the GDEM data selection pop-up window will appear 
as shown in Figure 17. This Window will contain various user-selectable options. The “Read” but- 
ton initiates the retrieval o f data from 'die database using the parameter range values shown below 
the “Minimum” and “Maximum” buttons of the pop-up window. The “Remark" section of the 
“Main Window” displays "Reading GDEM Data" during data retrieval and "finished reading 
GDEM Data" when retrieval is completed. The “Exit" button closes the GDEM data selection pop- 
up window. 
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Figure 17. DRM "Data Selection" pop-up window for the GDEM data type. 

To set any of the parameter values such as Month, Number of Parameters, Water depth. Latitude, 
and Longitude the “Minimum" or the "Maximum” button has to be selected first. The Month can 
be set by selecting the desired month from the list while the Number of Parameters can be set by 
moving the slider bar to the left or right till the desired value is shown. The water depth, latitude, 
and longitude can be set by typing the required values in the corresponding text boxes and pressing 
the <retum> kev. To select a particular version, the “Versions” button is selected. This results in a 
pop-up list window as shown in Figure 13, from where the desired version can be selected. 
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2.23.5.3 Options 

The GDEM Options pop-up window, as shown in Figure 1 8, allows for specifying the following 
options: 1 ) Data, Polygon, and Isolate Colors; 2) Location, Profiles, and Depth On/Off flags; 3) Pro- 
file, Polygon, and Isolate line widths; and 4) Data, Polygon, and Isolate point sizes. The line widths 
and the point sizes can be set by moving the corresponding slider bars till the desired value is dis- 
played. These settings control the thickness of the lines and points in the Main Chart and the Profile 
Chart areas. Clicking the “Reset” button returns all values to their original defaults. Clicking the 
“Ok” button closes the “GDEM Options” pop-up window, accepting the criteria established therein. 
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Figure 18. DRM "GDEM Options” pop-up window for the GDEM data type. 

2. 2.3.6 GRID1/GRID2 

The GRID1 and GRID2 data types uses the same interfaces a*, the GDEM data type in the data, 
display, and options categories. Refer to section 2.2. 3. 5. 

2.2.4 Data Interactive Module (DIM) 

The DIM supports manipulation of ocean data in the following ways: 

• Identification of data subsets by constructing polygons within the "Main 
Chart" or “Profile Chart"; 

• Enlargement of resolution (zoom) for improved interpretation/ analysis; 
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• Isolation of profiles; 

• Interpolation of displayed data into a contour; 

The DIM ‘Interact” and "Grid” window (see Figure 8) controls selection of data manipulation 
options within NIDAS-C. To activate an option, click its associated button. 

214.1 Zoom 

After selecting the “Zoom” button in the DIM “Interact” window, the zoom options pop-up win- 
dow (see Figure 1 9) will appear. If the “Zoomed Profiles Only” button is selected , only those profiles 
within the zoomed subregion of the “Main Chart" will be plotted on the “Profile Composite Chart”. 
If the “Overlay Zoomed Profiles” button is selected, profiles within the Zoom subregion will be 
plotted on the top of any existing profiles within the "Profile Composite Chart”. When the “Exit but- 
ton is clicked, the Zoom options pop-up window is closed and the “Zoom” function is activated to 
specify the 'ubrcgion for enlargement within the “Main Chart”. To specify the subregion, use the 
rubber band technique defined in Appendix A. The “Zoom” function will not work unless the speci- 
fied subregion is completely visible within the “Main Chart” window. Once the subregion for en- 
largement has been specified, the "Main Chart” window will display it. Profiles within the zoomed 
subregion will be plotted within the “Profile Composite Chart” in accordance with the plotting op- 
tion selected in the zoom options pop-up window. To return the “Main Chart" display back to its 
normal region depiction, select the “Default Region" menu item found under the “File” menu header 
(Section 2.2.2.3.1). 


O Zoomed Profiles only 
O Overlay Zoomed Profiles 


Exit 


Figure 1 9. DIM "Zoom Options" pop-up window. 


2J.4.2 Polygon 

After selecting the "Polygon” button in the DIM “Interact” window, polygon construction func- 
tions become active within eitherthe “Main Chart" or the “Profile Composite Chart”. The following 
rules apply iri constructing a polygon: 

• The Ifift mouse button is used to select the "Main Chart” or "Profile 
Composite Chart” for polygon construction. Simply place the mouse cur- 
sor within the border of the “Main Chart" or the “Profile Composite 
Chart” and click the left mouse button. The border of the chart will be 
highlighted in blue to indicate that it has been selected. 

• The middle mouse button is used to establish the comer points of a poly- 
gon. Maneuver the cursor to the position desired for a comer point and 
click the middle mouse button. At least three points must be defined in 
this manner to create a polygon. 
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* The right mouse button is used to close the polygon, which indicates that 
the definition of polygon comer points has terminated. The three (or 
more) polygon comer points will be connected, in the order in which they 
were created, to form the polygon. If the polygon does not appear to be 
drawn correctly, click the “Repaint" button located in the lower right cor- 
ner of the "Main Window” display to remove existing polygons. If less 
than three comer points were defined before clicking the right mouse but- 
ton, a message will appear in the “Remark" textbox stating "polygon 
should have at least three points . Start again.” In this case, you need to 
"repaint” and stait over. 

If the polygon is drawn from the "Profile Composite Chart", the profiles that have a depth point 
inside the polygon will be highlighted. All data within the polygon will be highlighted on both 
charts. 


2 .2.4.3 Polygon Options 


The Polygon Options pop-up window, as shown in Figure 20, allows for specifying the follow- 
ing polygon options: 1) Vertex and Edge colors, 2) Vertex size, 3) Edge Line width, and 4) Vertex 
symbol. The colors can be set by selecting the required color from the corresponding color pull- 
down list. The vertex size and the edge line width size can be set by moving the corresponding slider 
bars till the required values tire shown. The vertex symbol can be set from the symbol pull-down 
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Figure 20. DIM “Polygon Options" pop-up window. 

2. 2.4.4 Profile Isolation 

The Profile Isolation pop-up window, as shown in Figure 2 1 , allows for isolating individual pro- 
files of the currently displayed data profiles that has been polygoned. To list the profiles of a particu- 
lar data type, click on the corresponding data type button in the “Current Data Ty pe" section of the 
pop-up window. Individual or multiple profiles can be selected by selecting the "Single" or "Multi- 
ple” button from the “List Selecting Policy" section of the pop-up window. To select the profile(s) 
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click on the respective items on the list. The selected profiles are then highlighted in the “Profile 
Composite Chart” area and their corresponding locations are also highlighted in the “Main Chart” 
area. The pop-up window also supports the following for the profile(s) selected: 1 ) Flagging, 2) Up- 
dating database, 3) Exporting , and 4) Deleting. Click on the “Exit bu- ton to exit from “Profile Isola- 
tion”. 
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Figure 21. DIM “Profile Isolation” pop-up window. 

22.4.4.1 Flagging 

The “Flag" button is selected to set a particular flag for the profile(s) isolated (see Figure 22). 
To set a particular flag, click the required button. Only one ':lag can be set at a time. To reset the 
flag(s) click on the “Reset" button. To exit from the flag option click on the "Exit” button. 
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Figure 22. “Flag 0 options pop-lip window for profile isolation. 
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2. 2. 4.4.2 Update Db 

Click on the “Update Db” button to update the database with the changes made to the flags of 
the isolated profile(s). This button only updates the flags. 

2.2.4.43 Export 

Click on the “Export" button to export the isolated profile(s) (see Figure 23). Select “Binary” 
or “Ascii" to export in the binary or the ascii format. Type the output file names and header informa- 
tion and press the <retum> key in the corresponding text boxes. To export the data, click the “Ok” 
button. To exit from the export option, click the “Exit” button. 
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moodsExport.dat 


|~Ok 


Exit 


Figure 23. “Export” options pop-up window for profile isolation. 

22.4.4.4 Delete 

Click the "Delete" button to delete the isolated profile(s). The profiles are only deleted from 
memory and not the database, regardless of pressing the "Update Db" button. 

2.2.4.S GRID (Interpolation) 

2. 2. 4. 5.1 Charter 

To interpolate the displayed data to a contour, select one of the interpolation routines from the 
“Method" pull-down menu. (Only one interpolation routine is available for this release. This rou- 
tine is called "Charter” wi th a chrtr8 reader. This routine was provided by NAVOCF. ANO. "Other” 
is shown only ’o illustrate that additional routines can be added. "Other" has no function in this re- 
lease.) The user is then given the option to select a particular data type from among the data types 
“urrently displayed as shown in Figure 24. Select a data type by clicking one of the data type buttons 
to bring up the "Charter Values" pop-up window, as shown in Figure 25, to set the various charter 
grid data values. The data values that can be set are 1 ) Grid Interval; 2) Lower left, and upper right 
latitudes; 3) Lower ieft, and upper right longitudes, 4) Depth; and 5) Smooth value. The depth value 
can be set by selecting the desired value from the "Depth" list, while the smooth value can be set 
by selecting the “Smooth" or "Unsmoothed” option from the pull-down menu located under the 
Depth list. The "Smoothed” option is the "fort29" output file produced by the charter routine. The 
"Unsmoothed" option is the "fort. 14" output file produced by the charter routine. The rest of the 
data values cun be set by typing in the corresponding text boxes. To interpolate the data and exit from 
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the pop-up window, select the “Ok” button. To exit from this window, select the “Cancel” button. 
The “Help” button provides on-line help on this topic. 



Figure 24. DIM ’’Charter Data Type Selection”. 



Figure 25. DIM ’’Charter Values" pop-up window. 

22.4.5.2 Display 

After the data has been interpolated, it is ready to be displayed. To display the contour, select 
the “Display" button. The resulting contour is shown in the "Main Chart" window. 

22.4.5.3 Options 

Clicking the "Options" bution produces the “Charter Contour Options" pop-up window, as 
shown in Figure 26. The user can set the following charter contour options in this window: 1) min, 
max, and interval values; 2) land mask and label on/off flags; 3) isoline and label colors; 4) isoline 
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width; and 5) label height. The min, max, and interval values can be set by typing in the correspond- 
ing text boxes, while the land mask and the label on/off flags can be set by clicking the corresponding 
buttons. The colors are set by selecting the required color from the list of colors displayed when the 
“Isoline Color” and the “Label Color” buttons are selected. The isoline width and the label height 
are set by moving the slider bars till the desired values are obtained. Click the “Ok" button to register 
the values and exit from the window. Click the “Reset” button to reset any values set 
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Figure 26. DIM "Charter Contour Options” pop-up window. 


3 ERROR MESSAGES 

Some of user error messages and a small description of the message and its meaning are provided 
below. If there are any other problems with NIDAS-C that the DataBase Administrator can not fix, 
then call user / technical support at: 

Phone: (601)688-3085 

Fax: (601)688-7100 

E-Mail: abbott@cast.msstate.edu 

3.1 Starting NIDAS-C 

• ’’Error from db_itnrt” - NIDAS-C could not open and sum the data- 
base. Contact the DataBase Administrator. 

3.2 Reading Data 

• ”No versions available” - There are no versions in the database for the 
data type you have selected. Ingest data first and then try to read it. 
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• ’’Number of Versions is limited to 12.” - You can select multiple ver- 
sions when reading data, but the number of versions is limited to 12. Se- 
lect your versions again. 

• ”No data available for given conditions.” - No data meets die minimum 
and maximum criteria, increase the range on the minimum and maxi- 
mum. 

• ’’Multiple Versions, DB Update Disabled” - When multiple versions are 
read m, the flag updating is disabled. You can flag the data but you won't 
be able to update the database. 

3.3 Polygon 

• "Polygon should have at least three points. Start again.” - In order to 
create a polygon, you must have at least three points. "Repaint" and start 
the polygon again. 

3.4 Zoom 

• ’’Zoom is not done correctly.” — In order to zoom, you must make a rect- 
angular box around the area to zoom. If you make a line, tliis message 
will lie given. 

3.5 Export 

• "Display of some datasets is required to export data.” - At least one 
type of data has to be read into memory and displayed on the ’’Main 
Chart” in order to export data. 

• "Polygon lias to be drawn to export data.” - The ’’Export’’ utility ex- 
ports data that has been polygoned. Draw a polygon, then export. 

• ’’Error. File name should start with alphabetic character only.” - The 
filename provided to the export utility must start with a character from 
a/A to z/Z. 

• ’’Open file error, for writing In Vncexport.” - The ’’ ,1 ’ stands for the 
value in the environment variable ”NIDASC_EXP”. Check this variable 
and make sure it is {jointing to a valid directory and that that directory 
contains another directory called ”nc_export”. 

3.6 Interpolation (Charter) 

• "Display of gdem or moods required” - At least one type of data has to 
be read in and displayed on the "Main Chart" in order to interpolate data. 

• ’’Display of Temperature or Salinity required” - The interpolation util- 
ity requires that either temperature or salinity be the parameter being dis- 
played. This can be checked by looking at the "Profile Composite Chart" 
and seeing what the title is. It needs to be either ’Temp vs Depth” or "Sal 
vs Depth”. 
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• ”Ail Charter fields must be entered” - All of the values on the "Charter 
Values" pop-up window must be provided. One or more values has been 
left out. 

• ”Lat/Lon fields must include aV! (ex: DegreesMlnutes)” - The lati- 
tude and longitude must have a to separate the degrees from the min- 
utes. 

• "Open file error, for writing In temp file.” - This temp file is being 
opened for writing in the "/tmp/" directory. Make sure that you can write 
to this directory and that there is not a file by the name of ”charter_script". 

• "Error from split-b — Contour not created” - Something is wrong 
with the split-b program. Split-b is part of the interpolation utility and it 
is an executable. Make sure it is in your executable path. Also make sure 
that you can write to the "/tmp/" directory and in the current directory. 

The current directory is the directory that NIDAS-C was started from. 

• "Error from chrtr8 — Contour not created” - Something is wrong 
with the chrtr8 program. Chrtr8 is part of the interpolation utility and it is 
an executable. Make sure it is in your executable path. Also make sure 
that you can write to the "/tmp/” directory and in the current directory. 

The current directory is the directory that NIDAS-C was started from. 


4 NOTES 


4.1 System Considerations 

Installation is site specific and tailorable to the environment. Appendix C provides information 
specific to installation of NIDAS-C within the NAVOCEANO computing environment. NIDAS-C 
may be instal 'ed and executed from SunOS 4.x, SunOS 5 .x (Solaris), SGI 4. x, and SGI 5 .X. Howev- 
er, some graphical screens produced by NIDAS-C are color and memory intensive, and will cause 
termination of the software i f memory and color resources are insufficient. 

4.2 System/Software Requirements 

NIDAS-C is an integrated software system that requires the presence of both specific commer- 
cial off-the shelf software and government-provided software. 

• NIDAS-C was designed for execution under control of the UNIX operat- 
ing system on SunOS 4.x, SunOS 5.x (Solaris), SGI 4.x, and SGI 5.X. 

• NIDAS-C requires the presence of the X-Windows client-server environ- 
ment. 

• The Open Software Foundation's (OSF) Motif Toolkit (library) must be 
present and available in the execution environment. 
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• A runtime version UNIRAS ag/X Toolmaster software must be installed 
on the system and available in the execution environment to support Nl- 
DAS-C graphical display options. 

• The Oracle relational database engine must be installed on the system and 
available for execution as the vehicle for accessing data contained in the 
NIDAS-C database. 

• Of interest to programmers, the software code for this version of the NI- 
DAS-C was compiled using C and Fortran Compilers. 

• NIDAS-C is an imeractive application. It supports all standard X-Win- 
dows mouse and & board functions. 

4.3 Directory Map 

NIDAS-C software executables have been designed to execute using directory paths defined via 
UNIX environmental parameters and path names defined within user “login” or "eshre” files. These 
parameters must be determined during installation since they are system dependent. 

4.4 Security 

NIDAS neither supports nor restricts the overall classification of the computing environment; 
however, classification codes are contained in the header information of each profile. The NDBA 
controls access to NIDAS data by authorizing levels of access based on the clearance held by individ- 
ual users. 
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APPENDIX A. GLOSSARY OF TERMS 


Bathymetric - Pertaining to the depth of the ocean. 

Button- When used in relation to the mouse device, a button is one of three pressure switches, which 
may be pressed (clicked) to control some feature of the screen display. When used in relation to the 
monitor display, a button is a labeled area of the on-screen graphical design that resembles a switch 
which can be made active by pressure. 

Click - The act of pressing a button on the mouse. The term ‘‘click on", or simply "click”, is frequent- 
ly used to indicate that the user should maneuver the mouse cursor to a specified location on the 
screen (usually an area designed to resemble a button) and press (click) the appropriate button on 
the mouse. 

Computer Software Configuration Item (CSCI) - a software application or a major component 
thereof. 

Computer Software Component (CSC) - a top level functional module within a computer soft- 
ware configuration item (CSCI). CSC’s are generally considered to be one structural level below 
the CSCI. 

Cursor - A graphical symbol that identifies a position on a computer monitor screen. A cursor is 
sometimes controlled by moving a mouse device; otherwise, it is controlled from the keyboard, usu- 
ally with the arrow keys. 

Data Interactive Module (DIM) - NIDAS module that performs lata manipulation functions and 
processing required for display and in terpi station of data. 

Data Retrieval Module (DRM) - NIDAS module responsible for identifying , obtaining and for- 
matting data obtained from the NIDAS (NEONS) database. 

Display - Synonymous with the computer monitor screen; also, to demonstrate or to show. 

Drag - The act of pressing and holding a button on the mouse device and moving the mouse to con- 
trol acursor's position on the monitor screen. The purpose of dragging the mouse device is t o define 
an area on the screen or to move a graphical object to another location on the screen. 

Graphical User Interface (GUI) - NIDAS module responsible for interfacing with the user and 
controlling the functionality of the main NIDAS display. 

Julian - The day of the year according to the Julian calendar which begins on January 1 . A Julian 
date does not include a year as pan of its format. 

List - a simple series of words or numerals. 

Listbox - An outlined area of the display which contains a list of textual information. Selection of 
text within a list it accomplished by placing the mouse cursor over the appropriate entry and clicking 
a button on the mouse. 
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Metadata - Information about a dataset, either descriptive or definitive, as to quantity, quality, 
quantity or format. 

Mouse - a hand controllable device used to interact with images displayed on the computer monitor 
screen. When a mouse is moved, a cursor on the screen moves in the same direction as the mouse. 
One or more buttons may be present on a mouse for invoking an action on screen at the correspond- 
ing cursor position. 

Profile - A sequential listing of parameters keyed to a reference structure. A bathymetric profile 
contains sequential depth/parameter groups. 

Pull-down Menu — a listing of procedural options that appears in response to activation of an ap- 
propriately labeled (visible) button referred to as the menu header. Options are selected by clicking 
on the menu header to display the options, followed by clicking the button labeled to indicate the 
desired option. 

Rubber Band -- The act of dragging the mouse to define an area on the screen. A mouse button is 
pressed and held while the r ouse is maneuvered to positior the on-screen cursor at a desired final 
position; then, the mouse button is released. 

Screen - The display surface of a computer video monitor where images appear. 

Scroll Bar - The graphical image of a narrow bar with arrows embedded at both ends and, optional- 
ly, a movable (sliding) button between them. The scroll bar is used to position a portion of an image 
or text for viewing inside a bound area that is smaller than the whole image or text. Scrolling is ac- 
complished by placing the mouse cursor on one of the arrows and pressing the mouse button. Scrol- 
ling may also be accomplished by placing the mouse cursor over the sliding button (if present) and 
dragging the sliding button to a new position along the scroll bar. 

Textbox — An outlined area of the display that contains textual information. Text in a textbox may 
sometimes be edited; however, the usual purpose of a textbox is to provide information to the user. 

Widget- "..a graphical device capable of receiving input from the keyboard and the mouse and com- 
municating with an application or another widget by means of a callback. Every widget is member 
of only one class and always has a window associated with it. ’’(from: OSF/Motif Programmer's 
Guide , Rev. 1.1 Open Software Foundation, Prentice Hall, Englewood Cliffs, NJ, I991,p.GL-13.) 

Window — An outlined area of the screen whose contents are confined to the outlined boundary and 
controlled by user interaction (with buttons, menus, etc.). A window is usually a top level structure 
closely tied to the operating environment of the computer. 

Zoom -- The graphical scaling process whereby a screen display item is enlarged or reduced in size. 
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APPENDIX B. LIST OF ACRONYMS 


ASCD - American Standard Code for Information Interchange 

AUX1 - Auxiliary MOODS Dataset 1 

AUX2 - Auxiliary MOODS Dataset 2 

CAST - Center for Air Sea Technology 

CLIMO - Climatology 

CSC - Computer Software Component 

CSCI - computer software configuration item 

DBDR - Database Design Requirement 

DBFR - Database Functional Requirement 

DOD - Department of Defense 

DIM - Data Interactive Module 

DRM - Data Retrieval Module 

GDEM - General Digital Environmental Model 

GUI - Graphical User Interface 

Lat - latitude 

Lon - longitude 

Max - Minimum 

Min - Minimum 

MOODS - Master Oceanographic Observation Data Set 

MSU - Mississippi State University 

NASA - National Aeronautics and Space Administration 

NAVOCEANO - Naval Oceanographic Office 

NDBA - Nil) AS Database Administrator 

NDMS - NIDAS Data Management System 

NEONS - Navy Environmental Operational Nowcast System 

NDR - NIDAS Data Requirement 

NFR - NIDAS Functional Requirement 

NIDAS-C - Naval Interactive Data Analysis System - Climatology 
OSF - Open Software Foundation 
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RDBMS - Relational Database Management System 

Sal - salinity 

Snd speed - sound speed 

SQL - Structured Query Language 

Temp - temperature 
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APPENDIX C. NIDAS-C INSTALLATION PROCEDURES 


The following instructions expl ain how to install NIDAS-C. These instructions have been pro- 
vided with the NIDAS-C software as a "README” file, and contain the following sections: 

• Prerequisites 

• Creating the proper Environment 

• Importing the DataBase 

• Installing the Softwtire 

• Clean-Up 

• Remarks 

Prerequisites 

**• The software must be downloaded off die tape and in the correct directory to 
where NIDAS-C is to be installed. The software is in the form of a tar file that 
has been loaded onto the tape. The tar file has been loaded onto the tape from a 
SunOS system using tar to load it with. The System Administrator will need to 
help with this. After the tar file has been downloaded off the tape and put into 
the proper directory, it can be untared with the command tar -xvf ONI- 
DAS_SW.tar. This will create a directory call ONIDAS SW. Remember this di- 
rectory as it will be used in creating the user environment. 

«r Oracle must be up and running and a database created for nidas. For example, 
the database can be named nidas. An oracle user must exist with the name neons 
with a password of neons. Caution must be exercised when creating the nidas 
database to make sure that the rollback segments and the tablespaces are large 
enough. When a transaction is initiated, a rollback segment is selected to hold 
that transaction. Only one segment is used per transaction. Therefore, all of the 
rollback segments have to be large enough to handle the largest transaction. The 
recommendation is to have one or more rollback segments with at least the size of 
SOM. The following is the required name and recommended sizes for the table- 
spaces: 

• GEOGRAPHIC - This is for the geographic data. Size: 200M 

• INDEX ._PRIMAIRE_NEONS - This is for the indexes for the primary 
data. Size: 200M 

• PRIMAIRE_NEONS - This is for the primary data. Size: 350M 

• NEONS - This is for other meta data. Size: 200M 

«* The UNIRAS graphics package must have been installed and the license daemon 
running. 
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Creating the proper Environment 

These changes and additions are to be made to each user’s .eshre file. For this example. NI- 
DAS-C is to be installed in the directory I usrl people! nidas. After making these changes, the .eshre 
file must be sourced. This can be done by the command source -/.eshre. 

*r Make Sure: UNIDIR points to the UN1RAS software. 

(ex: setenv UNIDIR Aisr/uniras/6v4a) 

w Make Sure: UNIRAS login file has been sourced. 

(ex: source $LNIDIR/base/uni.login) 

u Make Sure: ORACLE_HOME points to the oracle software. 

(ex: setenv ORACLEJHOME /opt/oracle/product/7.1.4) 

«r Make Sure: ORACLE_SID points to the nidas database. 

(ex: setenv ORACLE_SID nidas) 

*** Add: setenv ORA_NIDAS_SW /usr/peopIe/nidas/ONIDAS_SW 

This environment variable points to the NIDAS-C software directory. It will be 
used by the software. 

«r Add: setenv ORA_NEONS_SW $ORA_NIDAS_SW/oneons_sw 
This environment variable points to NEONS software. 

ct Add: setenv ORA_NIDASC_EXP - 

This environment variable points to a directory that you, as a user, have write per- 
mission. This directory is for the export files to be exported to. In the directory 
specified by this variable there should be another directory named ncjexport. 

This is the directory that: NIDAS-C puts the export files. 

«r Add: setenv DBA nidas 

This environment variable points to the nidas dba account that you are installing 
NIDAS-C under. This has to be a real user that owns the software. 

«*• Add: setenv XAPPLRESDIR -/app-defaulte 

This environment variable points to your application default resource directory. 

If you do not have this directory in your home directory, it must be created. 

w Add: set path - ( $path $ORACLE_HOME/bin $ORA_NIDAS_SW/bln ) 

This adds the NIDAS-C executable directory and the Oracle executable directory 
to your path. If you do not have a path to begin with, take ”$path” out of this 
command. 

»*■ Add: source $ORACLE_HOME/bln/coraenv 

This brings in the rest of the ORACLE environment. 

Importing the Data Base 

Change the current directory to $ORs\_NIDAS_SW' (cd $ORA_NIDAS_SW) and execute 
INSTALL. This is simple script that will ask a few questions and then compile the software. 

«*• You will be asked if you want to clean, clobber, or install the software. Answer 
no to the clean and clobber by typing n followed by the <retum> key. Then an- 
swer yes to the install by typing y followed by the <retum> key. 
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» Then you will be asked if you want to install the nidas database. Answer yes to 
this question by typing y followed by the <retum> key. This executes olm- 
portjdb which uncompresses the import file, imports the database into oracle, 
and compresses the import file. This step can be done manually by executing 
olmport_db. This step also compiles some data utilities. This can be done 
manually by changing to the $ORA_NIDAS_SWtsample_dataln_utilities (cd 
$ORA_NIDAS_SW/sarap]e_data/n_utilltFes) and executing the command 
make -f makeJVlACHINE where MACHINE is either sun, sol, sg' . or sgi5. 


Installing the Software 

w Refer to Importing the DataBase for installing the data utilises. 

Then you will be asked if you want to install the NEONS software. Answer yes 
to this question by typing y followed by the <retum> key. This can done manual- 
ly by changing to the $ORA_NEONS_SWIHbsrddbJo , $ORA NEONS_SW/ 
libsrc/db_util , and $GRA_NEONS_SWIlibsrd nidas Jo directories and executing 
make -f make.MACHINE install where MACHINE is either sun, sol, sgi4, or 
sgi5. 

or Then you will be asked if you want to install the NIDAS-C software. Answer 
yes to this question by typing y followed by the <retum> key. This can done 
manually by changing to the $ORA_NIDAS_SW/onidas-dsrc directory and 
executing make -f make.MACHINE Install where MACHINE is either sun, sol 
sgi4, or sgi5. Then changing to the $ORA NIDAS JSWlonidas-ddba directory 
and executing make.MACHINE install where MACHINE is either sun, sol. 
sgi4, or sgi5. 

Clean-Up 

**■ You need to copy the "app-defaults” files to your app-defaults directory. You 
can do this by executing the command cp $ORA NIDAS SvV/app-defaults/* 
SXAPPLRESDIR/. 

If you are installing NIDAS-C on a SGI, you need to copy the "app-defaults" file 
to the system app-defaults directory. This has to be done by the system adminis- 
trator logged in as root. As root, execute cp $ORA_NIDAS_S\V/app-defaults/* 
/usr/llb/Xl l/app-defaults/. 

Remarks 

m Some sample data has been provided for ingestion. This data is located in the 
$ORA_NIDAS_SWt sample data directory as moods and n test data. 

m The executables that are provided and created are as follows: 

• nidas-c - Nidas Climatology 

• nidas-c_dba - DbaTools for Nidas Climatology 

• nidas-c Jllt_wr - Ingest routine for Nidas Climatology 
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• split-b - Splits data (master format) into Temperature and Salinity 

• chrtr8 - Interpolates grid into chrtr format 

• chrtrout - Reads bathy data (chrtr format) and makes ascii file for viewing 

• binmaster - Subsets a master format file by location, month, instrument, 
and/or bottom depth 

• dumpheader - Reads lit data and makes ascii file of header only 

• dumpm - Reads lit data and makes ascii file for viewing 

• farfinger - Reads ascii file of lit profiles created manually by a user and 
converts to master format 

• imakemaster - Converts MOODS admin format to master ”B” file format 
for Nidas ingest 

• Iclimfacs - Reads volume data (3-D climatology and model grids) and 
lists jxrtinent information 

• provprof-master - Reads Nidas export file for ’’synthetic” profiles and 
converts to master format 

• filefacs - Reads lit data (master format) and lists pertinent information 
about the data set 
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